home *** CD-ROM | disk | FTP | other *** search
/ SPACE 1 / SPACE - Library 1 - Volume 1.iso / utilitys / 609 / cachev3 / cachev3.doc next >
Text File  |  1991-03-27  |  11KB  |  265 lines
  1.  
  2.                                Cold Hard Cache 3.5
  3.  
  4.  
  5.                                Cold Hard Cache 3.5
  6.  
  7.                       for the Atari ST and MEGA ST Computers
  8.                            with or without a Hard Disk
  9.  
  10.                        Copyright 1989, Robert E. Owens III
  11.  
  12.  
  13.              Cold Hard Cache is an easy to use disk caching  program  that
  14.         works  with both hard drives and floppies.  Disk caching  improves
  15.         disk  I/O  speed  by  keeping  the  sectors  that  are  used  most
  16.         frequently in RAM. The I/O speed of a cached drive will be between
  17.         that of a RAM disk (very fast) and the uncached drive (much slower
  18.         than a RAM disk).
  19.  
  20.              Benefits:
  21.              o  Faster disk operation.
  22.              o  Longer life for your disk drives.
  23.              o  Longer life for your media.
  24.              o  Less waiting on programs that grind your disks.
  25.  
  26.            Drawbacks:
  27.              o    The  cache program and the sector buffers take  up  some
  28.                   RAM memory (about 20K minimum).
  29.  
  30.              Cold Hard Cache was designed to be as small, reliable, and as
  31.         fast as possible.  The program buffers reads only.  All writes  go
  32.         directly to disk unless the sector is already in the cache and the
  33.         data  has not changed.  This ensures that the disk's contents  are
  34.         current  in  case  of a  crash,  power  failure,  or  accidentally
  35.         powering off the computer.
  36.  
  37.              The size of the code may surprise you.  Good things  come  in
  38.         small packages. Version 1.0 was about 8K long while Version 3.5 is
  39.         just over 2K long.  The code has been carefully refined and tested
  40.         for  about  two years on several models of hard  drives  including
  41.         Atari,  Supra,  and  ICD models and should be compatible with  any
  42.         other models.
  43.  
  44.         Included Files:
  45.  
  46.              cachev3.prg    The caching program.
  47.  
  48.              chcstat.prg    The   GEM   application   status/configuration
  49.                             program.
  50.  
  51.              chcstat.acc    The    GEM   accessory    status/configuration
  52.                             program.
  53.  
  54.              chcstat.rsc    The GEM resource file for both chcstat.prg and
  55.                             chcstat.acc.
  56.  
  57.              chcache.doc    This file.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.                                       - 1 -
  66.  
  67.  
  68.                                Cold Hard Cache 3.5
  69.  
  70.  
  71.         Installation:
  72.  
  73.         1.   Place the following files in the root directory of your  boot
  74.              disk:
  75.                   chcstat.prg
  76.                   chcstat.acc
  77.                   chcstat.rsc
  78.  
  79.         2.   Place cachev3.prg in the AUTO folder of your boot disk.  Make
  80.              sure it is placed after your hard disk driver (like  AHDI.PRG
  81.              on  Atari drives).  Also,  if you are  networked,  make  sure
  82.              cachev3.prg is placed BEFORE your network driver or there  is
  83.              a very good chance of scrambled files.
  84.  
  85.  
  86.         Configuration/Status Reporting:
  87.  
  88.         General:
  89.  
  90.              There are two versions of the  configuration/status  program.
  91.         Chcstat.prg and Chcstat.acc. They both operate the same except one
  92.         is a stand-alone program and the other is a desk accessory. I will
  93.         refer to these as the Chcstat from here on.
  94.  
  95.              Chcstat first tests whether cachev3.prg is installed.  If  it
  96.         is not Chcstat will complain. Then a dialog is displayed.
  97.  
  98.              The  top half of the dialog contains performance  and  status
  99.         info. The bottom half contains configuration settings.
  100.  
  101.  
  102.         Configuration:
  103.  
  104.              You may choose the size of the cache and the drives you  wish
  105.         to be cached.  The size of the cache is measured in buffers.  Each
  106.         buffer requires 524 bytes (512 for the sector,  12 overhead).  The
  107.         cache should be at least 32 buffers but not too big. I usually use
  108.         256  buffers (about 128K).  You can try various sized  caches  and
  109.         watch the statistics to find a good size.
  110.  
  111.              You may choose the maximum sized multi-sector transfer to  be
  112.         considered  cachable.  The  default  setting is  4  (512  bytes  *
  113.         4 sectors = 2K). You may specify any value from 1 to 9999 sectors.
  114.         Large  values  will  cause  a  loss  of  performance  since  large
  115.         transfers  (like  program  loads) will fill the  cache  and  flush
  116.         potentially useful sectors (like directory and FAT  sectors).  You
  117.         may  tune  the  cache for your particular  needs.  If  you  use  a
  118.         database  with large records you may wish to specify a larger  max
  119.         size to accomodate the size of your records.
  120.  
  121.              You may also choose the drives you wish to be cached.  Select
  122.         the  drives  with the mouse.  Caching is enabled on  the  Selected
  123.         drive letters. There is no harm if you enable a drive that doesn't
  124.         exist.  If  you enable caching on a ramdisk you will make it  work
  125.         SLOWER than if it was not cached.
  126.  
  127.  
  128.  
  129.  
  130.  
  131.                                       - 2 -
  132.  
  133.  
  134.                                Cold Hard Cache 3.5
  135.  
  136.  
  137.         Status/Performance:
  138.  
  139.              The status and performance info is useful for tuning the size
  140.         of  the cache for optimum performance for  your  hardware/software
  141.         environment.  The performance is based on cachable sectors.
  142.  
  143.              An  average  access time is  given  (in  milliseconds)  which
  144.         represents the average time it takes to locate and read a cachable
  145.         sector  from disk.  The average is for all of the enabled  drives,
  146.         not just one drive.
  147.  
  148.              The approximate read time is displayed which  represents  the
  149.         total amount of time it took to read all of the cachable sectors.
  150.  
  151.              The approximate time savings is calculated from  the  average
  152.         access  time and the number of sector requests satisfied from  the
  153.         cache (Hits).
  154.  
  155.              The read status shows the number for cachable sector requests
  156.         (tries),  the  number of those requests satisfied from  the  cache
  157.         (hits), and the percentage of hits.
  158.  
  159.              The  number  of write optimizations  is  displayed.  A  write
  160.         optimization  occurs  when  a sector write is  requested  and  the
  161.         sector  is  in the cache AND the contents of the sector  does  not
  162.         change so no write takes place.
  163.  
  164.         Exiting:
  165.  
  166.              There are three ways of exiting the dialog.
  167.  
  168.              Cancel    The Cancel button will exit without changing any of
  169.                        the settings.
  170.  
  171.              OK        The  OK button will enable the selected drives  and
  172.                        then exit. Any changes to the size will be ignored.
  173.                        If   the  Reset  Stats  button  is   selected   the
  174.                        statistics will be reset.
  175.  
  176.              Save      The  Save button will save the current settings  in
  177.                        the cache.inf file (so they will take effect  after
  178.                        the next boot), enable the selected drives and then
  179.                        exit.  If  the Reset Stats button is  selected  the
  180.                        statistics will be reset.
  181.  
  182.  
  183.         NOTE:     The cache program cachev3.prg must be positioned in  the
  184.                   AUTO  folder after your hard disk driver  (ahdi.prg  for
  185.                   Atari drives) and before any network drivers.
  186.  
  187.         NOTE:     If  the alternate key is held down when  cachev3.prg  is
  188.                   run (from the \auto folder during the boot process)  the
  189.                   cache will NOT be installed.
  190.  
  191.         NOTE:     Users  of  TURBODOS  may  see  lower  performance  since
  192.                   TURBODOS  does some caching  internally.  TURBODOS  will
  193.                   disable  caching on floppies since it  bypasses  RWABS()
  194.                   and the ROM routines that handle floppies.  Cachev3 when
  195.  
  196.  
  197.                                       - 3 -
  198.  
  199.  
  200.                                Cold Hard Cache 3.5
  201.  
  202.  
  203.                   used with TURBODOS can still give good results if  there
  204.                   is lots of disk activity. Try it and see what you get.
  205.  
  206.         NOTE:     Cachev3   should  work  with  TOS  1.4   with   Extended
  207.                   partitions (> 16 Meg) however only the first 16 Meg will
  208.                   be cachable.  THIS HAS NOT BEEN TESTED!  TRY IT AT  YOUR
  209.                   OWN  RISK!  MAKE  SURE YOU HAVE A BACKUP OF  YOUR  DRIVE
  210.                   BEFORE YOU TRY!
  211.  
  212.         NOTE:     Cachev3  prevents  writes to the boot sector (#  0)  for
  213.                   enabled  drives.  This will prevent utilities that  make
  214.                   partitions  bootable (or viruses) from working.
  215.  
  216.         NOTE:     Some  Hard  Disk  utilities  (like  markbad)  will   not
  217.                   function correctly when the caching is  enabled.  Simply
  218.                   disable   the  drives  with   the  chcstat  program   or
  219.                   accessory.
  220.  
  221.         BUG ALERT:
  222.              Cold   Hard  Cache  3.2  did  NOT  recognize  Media   Changes
  223.              correctly.  This  may have affected Removable Hard Drives  as
  224.              well as Floppies.  This has been corrected in version 3.3.
  225.  
  226.              Cold Hard Cache 3.3 would crash (Address error) if a read  or
  227.              write request specified a transfer to or from an odd  address
  228.              (very rare). This has been corrected in version 3.4.
  229.  
  230.              Cold Hard Cache versions before 3.5 would not allow  floppies
  231.              to  format  correctly.  Writes to the Boot  Sector  were  not
  232.              permitted.  They are now allowed for floppies but NOT allowed
  233.              for drives C through P.
  234.  
  235.  
  236.  
  237.              Cold  Hard  Cache  was  written using  the  Mark  Williams  C
  238.         Compiler. I highly recommend this product.
  239.  
  240.  
  241.              Cold Hard Cache is released as Shareware.
  242.  
  243.              If  you use this program please make a donation ($15  or  so)
  244.         to:
  245.  
  246.              Robert E. Owens III
  247.              34 Pinecrest Dr.
  248.              Covington, LA 70433
  249.              USA
  250.  
  251.              This  program was designed to save time and has proved to  be
  252.         valuable. I usually save 20 to 40 minutes a day!
  253.  
  254.  
  255.              If you have any suggestions or comments about this program  I
  256.         would like to here from you. I can be reached by Stamp Net (at the
  257.         above address) or on Genie (at R.OWENS3).
  258.  
  259.  
  260.  
  261.  
  262.  
  263.                                       - 4 -
  264.  
  265.